home *** CD-ROM | disk | FTP | other *** search
/ PC Open 93 / PC Open 93 CD 1.bin / internet / AmphetaDesk / docs / README.txt < prev    next >
Encoding:
Text File  |  2002-06-20  |  7.6 KB  |  171 lines
  1. ###############################################################################
  2. # AmphetaDesk                                           (c) 2000-2002 Disobey #
  3. # README.txt                              http://www.disobey.com/amphetadesk/ #
  4. ###############################################################################
  5.  
  6.  
  7.      This is the README.txt file for AmphetaDesk. Within, you'll
  8.       find installation instructions (you're already 90% done).
  9.         Further documentation is located in /docs/index.html
  10.            If you have problems, email morbus@disobey.com.
  11.  
  12.  
  13. Located Below:
  14. --------------
  15.  - Upgrade Notes
  16.  - Windows (95, 98, 2000, ME, NT, XP) Installation
  17.  - Macintosh (7.5 through 9.2.1, OS X) Installation
  18.  - Linux and Mac OS X Source Installation
  19.  
  20.  
  21. ###############################################################################
  22. # Upgrade Notes                                                               #
  23. ###############################################################################
  24.  
  25. Upgrading consists of moving two files into the new installation.
  26.  
  27.  1) Install AmphetaDesk in a different location than your current install.
  28.     Optionally, you can install over your current installation directory,
  29.     but you may want to back up the two files below before doing so.
  30.  
  31.  2) Your current channel subscriptions and settings are contained within:
  32.  
  33.       /path/to/current/amphetadesk/data/myChannels.opml
  34.       /path/to/current/amphetadesk/data/mySettings.xml
  35.  
  36.  3) To upgrade, simply copy those two files into the /data/
  37.     directory of your newly installed version of AmphetaDesk.
  38.  
  39.  
  40. ###############################################################################
  41. # Windows (95, 98, 2000, ME, NT, XP) Installation                             #
  42. ###############################################################################
  43.  
  44.  1) Unarchive the .zip file into a directory of your choice.
  45.  2) You should have a directory with some folders and "AmphetaDesk.exe".
  46.  3) Doubleclick "AmphetaDesk.exe" to start the program.
  47.  4) Optionally, put a shortcut to the .exe on the Desktop or Start Menu.
  48.  
  49. That's it! Upon doubleclicking "AmphetaDesk.exe", a small window will
  50. appear stating that it is downloading various files. Shortly thereafter,
  51. your browser will open and you'll be able to start using AmphetaDesk.
  52. Whenever you wish to use AmphetaDesk, simply double click the .exe.
  53.  
  54.  
  55. ###############################################################################
  56. # Macintosh (7.5 through 9.2.1, OS X) Installation                            #
  57. ###############################################################################
  58.  
  59.  1) Unarchive the .sit.hqx file (Classic) or the
  60.     dmg.gz (OS X) into a directory of your choice.
  61.  2) You should have a directory with some folders and "AmphetaDesk".
  62.  3) Doubleclick "AmphetaDesk".
  63.  
  64. That's it! Upon doubleclicking "AmphetaDesk", a small window will appear
  65. stating that it is downloading various files. A minute later, your
  66. browser will open and you'll be able to use AmphetaDesk fully. Whenever
  67. you wish to use AmphetaDesk, simply double click the application.
  68.  
  69.  
  70. ###############################################################################
  71. # Linux and Mac OS X Source Installation                                      #
  72. ###############################################################################
  73.  
  74.             NOTE: AmphetaDesk is runnable on OS X without going
  75.              through the instructions below. Simply double click
  76.              the "AmphetaDesk" application (with the pill icon).
  77.  
  78.  
  79.  1) Unarchive the .tar.gz file into a directory of your choice.
  80.  2) You should have a directory with some folders and AmphetaDesk.pl.
  81.  3) Install some modules from CPAN. To do so, run the below:
  82.  
  83.        perl -MCPAN -e shell
  84.  
  85.     If this is your first time using CPAN, you'll be asked some questions
  86.     concerning your configuration. Most of the defaults are fine - these
  87.     questions need to be correct to correctly download the modules you need.
  88.  
  89.     At the CPAN prompt, type the following and press <return>:
  90.  
  91.        install Bundle::LWP
  92.  
  93.     This will download and install a number of modules. Just sit tight
  94.     and watch the output scroll by. Eventually, you'll be returned to
  95.     the 'cpan>' prompt.
  96.  
  97.  
  98.        #######################################################################
  99.        # did errors occur above? if so, read below, else skip below.         #
  100.        #######################################################################
  101.  
  102.        If the last few messages from the output of your command concern
  103.        errors, or tell you that installation won't continue, then we'll
  104.        need to force an install. Some sample errors are shown below:
  105.  
  106.            make[1]: *** [xmlwf] Error 1
  107.            make: *** [xmlwf] Error 2
  108.            Make had some problems, maybe interrupted? Won't install
  109.  
  110.        Generically speaking, forcing an install of CPAN modules is not a
  111.        good idea, as it suggests something is wrong in the first place.
  112.        If you're in a hurry, enter the following. If you're NOT in a
  113.        hurry, then you should probably try to find out what the
  114.        problem is. Enter the following at the CPAN prompt:
  115.        
  116.           force install Bundle::LWP
  117.  
  118.        #######################################################################
  119.        # don't continue below until you've installed Bundle::LWP correctly.  #
  120.        #######################################################################
  121.  
  122.     Now, we need to install expat, which is an XML parser. To do so,
  123.     grab the latest version from http://expat.sourceforge.net/ and 
  124.     follow the instructions within that archive. Once it's installed,
  125.     we'll continue on with our installation.
  126.  
  127.        #######################################################################
  128.        # don't continue below until you've installed expat correctly.        #
  129.        #######################################################################
  130.  
  131.     Now, we're almost done. Load up CPAN again by entering:
  132.  
  133.        perl -MCPAN -e shell
  134.  
  135.     And type the following at the CPAN prompt:
  136.  
  137.        install XML::Parser
  138.  
  139.        #######################################################################
  140.        # are you running Macintosh OS X? Read this, else, skip below.        #
  141.        #######################################################################
  142.  
  143.        You must install XML::Parser manually, due to it not being able to
  144.        find the expat library we just installed. To do so, download from
  145.        http://www.cpan.org/authors/id/C/CO/COOPERCL/XML-Parser.2.31.tar.gz
  146.        and extract to a directory of your choice. Within the shell, navigate
  147.        to that directory and enter the following commands:
  148.  
  149.           # this first command is ALL ONE LINE.
  150.           perl Makefile.PL EXPATLIBPATH=/usr/local/lib/
  151.                            EXPATINCPATH=/usr/local/include/
  152.           make
  153.           make test 
  154.           sudo make install
  155.  
  156.        #######################################################################
  157.        # got XML::Parser installed? You're almost done!                      #
  158.        #######################################################################
  159.  
  160.     At this point, all the necessary CPAN modules should be installed.
  161.  
  162.  4) Give AmphetaDesk execute permissions: "chmod 755 AmphetaDesk.pl"
  163.  5) Once the modules are installed and permissions have been
  164.     granted, you should be able to run either "AmphetaDesk.pl"
  165.     or "./AmphetaDesk.pl" 
  166.  
  167.  
  168. ###############################################################################
  169. #              Further documentation lives in docs/index.html.                #
  170. ###############################################################################
  171.